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I Introduction 

rAas is a loader/debugger that runs on an Alto and controls its target machine remotely. It can 
H/dump microprograms assembled by Micro, examine and modify storage, and test hardware in 
ral ways. Versions exist for Maxc2, Dorado, DO, and M68 microprocessors. 

vfdas is coded about 95% in Bcpl and 5% in assembly language. The Maxc2 version was 
• nlemented by E. R. Fiala and H. E. Sturgis. The Dorado, EX), and M68 versions consist of 
niachine-independent modules implemented by E. Fiala (Overlay and LoadRAM packages 
imolemented by L. Deutsch and Alto microcode by E. Taft are also used) and machine-dependent 
sections implemented by E. Fiala for Dorado; D. Swinehart and P. Baudelaire for M68; and D. 
Charnley, C. Thacker, B. Rosen, C. Hankins, and E. Fiala for DO. 

An internal description of Midas is available to anyone interested in adapting Midas to a new 
hardware system (see [Ivy]<DoradoDocs>MidasInteraal,Press). 

2. Storage Requirements 

Midas requires about 500 Alto disk pages, using the following files: 



Error message strings for Midas swat calls 

(Discussed below) 

(Discussed below) 

Command files for "RunPr<%" and "Read-Cmds" actions 

Assorted miao-binaiy files loaded by ccnounand files 

Built by Midas/I 

Built by Midas/I 

Created by Midas/I (used when loading .MB files) 

Qeated by Midas/I. written when "Qanpare" fails 

DO Midas can be obtained by loading [Ivy]<D0>D0MidasRun.Dm and retrieving 
<DO>Midas.Programs with Ftp. You must do Midas/I to initialize Midas on your disk after 
retrieving these. Subsequentiy, new versions of Midas can be retrieved by executing the 
D0NewMidas.Cm command file from the Alto Executive. Midas runs only under OS versions 17 
or later. 

To setup an Alto disk for use in DO microcode development or hardware debugging, you can 
install the Alto OS on a blank disk using tiie long installation dialog and erase the disk. When 
this finishes, fetch [Ivy]<DO>DODebuggingDisk.Cm and execute tiiis conmiand file from the Alto 
Executive; it will retrieve Midas and a number of other files needed when using an Alto for DO 
hardware debugging and microcode development 



Midas.Run 


-350 pages 


Midas.Syms 


~40 pages 


Midas^Errors 


•"S pages 


MidasJPrograms 


-2 pages 


Midas-UserPrograms 


~2 pages 


•Midas 


~2 pages each 


•jnb 




Midas.RunProg 


~31 pages 


Midas-Dtach 


~31 pages 


Midas.FixUps 


~2 pages 


MidasCompare 


-2 pages 
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3. Starting and Exiting from Midas 

Midas may be started from the Alto Executive in the following ways: 

midas/i initializes (required when any Midas files move or change); 

midas simply fires up Midas; 

midas debug starts Midas and immediately reads commands from the 

"Debug.Midas" command file 

Note: You are required to type midas/I when you change any of the files "known" to Midas; 
tliese files include the Alto OS, Midas.Run, Midas.Programs, Midas.Midas, Midas.UserPrograms, 
any of the *.Midas files that appear in the "Run-Prog" or "Read-Cmds" menus, and any of the 
*.Mb files used by the "Run-Prog" menu items. 

At present, Midas will boot its connected DO at startup. The "Boot" action, which appears in 
both the main command menu and the submenu put up by "Go," will cause the DO to load and 
sitart its boot loader (which overwrites any microprogram previously loaded); Midas then 
communicates with the boot loader to load its Kernel microprogram, which resides in parts of 
pages 0, 1^, and 17 of the microstore; subsequentiy, interactions between Midas and die DO are' 
carried out by messages exchanged between the Kernel microprogram and Midas using the Alto's 
Diablo printer interface. 

The locations used by Kernel are available to microprograimners through the file KemelOccupiedMc which 
is in [Ivy}<DOSource>KeraelSouroes.Dm; thwe are provisions for overwriting most of Kernel when running 
large microprograms. 

In the initial display arrangement, the left-hand display column shows the principal DO registers, 
and the right column shows several other items. When you initially start Midas and after a "Run- 
I^og" action, the display will be set to this configuration. 

To exit from Midas you may type either SHEFT-SWAT (i.e., simultaneously depress tiie left-hand 
shift key and tiie right-most, lowest unmarked key) or ";Q" or you may bug "Exit"; tiiis will close 
any open output files prior to exit Note that on exit, if the DO was running, it v^ not be 
disturbed. ' 
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4. Midas Display and the Mouse 

The Midas display is arranged as follows: 

Blank area at the top (unused); 

20 lines x 3 columns of name- value menus; 

Blank line; 

l^ogram and elapsed time line; 

Blank line; 

Two command comment lines; 

Blank line; 

'^rhree lines of command menu; 

Blank line; 

Input text line; 

Blank area a the bottom (unused). 

The program line will show the Midas release date or the name of the last program loaded. The 
right-most part of this line will show elapsed time during long-running actions such as "Go" or- 
"Test"; it shows the execution time of Midas initialization, the last command file, or tiie last action 
at other times. 

Midas uses the two comment lines to report results of actions that it executes. 

When you move the mouse over a name-value menu or the command menu, the selected item (if 
any) inverts black and white. Mouse actions execute when you RELEASE all mouse buttons, so 
you can move the mouse with buttons depressed without causing damage. If the mouse has 
moved off of the menu that was selected when the first button went down, notiiing will happen 
when the buttons are released. 

Some menus have additional actions "underneath" the ones normally displayed which will appear 
when you depress appropriate button combinations, as discused below. In other words, when you 
DEP1R.ESS buttons, the menu may change; when you RELEASE ALL BUTTONS the selected 
action will get executed. On DO Midas, only name-value menus have actions underneath the ones 
normially displayed. 

Smc€! you can neither depress a button combination simultaneously nor release the buttons 
simultaneously, Midas accumulates the union of all buttons that go down. This button-union 
goveins the "underneath" menu displayed, if any, and is the argxmient passed to the action 
proc€!dure when all buttons are finally released. 
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A name-value menu may contain a register or memory address in the name area and its contents m 
the value area. A memory address may be specified as the memory name and word number, or as 
the name of an address symbol defined in a microprogram you have loaded. The address symbol 
may be followed by +/■ displacement. If a number (default radix 8) is examined, the memory 
name is defaulted to "VM," so examining "1234" will cause "VM 1234" to be displayed. 

Name-value areas are of di^erent sizes. Smaller menus on the left are akeady filled in when you 
fire-up Midas; others are empty. Any item can be put in any menu, but larger menus on the 
right are better for items with long names or values. If an item overflows its menu, the nght-most 
characters of its name get truncated, then the left-most characters of its value. 

To display a new item, type its name (which will appear on the input text line), move the mouse 
over the name field in a name-value menu, and push-and-release the left (top) mouse button. 
Memory addresses in your microprogram may optionally be followed by a displacement +n or 
"-n"; " n" is the same as "-hn". Midas will obtain the value of the item from the hardware and 
display it 
If the command line is empty, the selected menu will be cleared when the button is released. 

The address and data items in a name-value menu are affected by the radix and display mode for 
the item, initially defaulted from a table indexed by the register or memory number. The address 
offset and value radices are always identical-Midas does not allow these to be mdependentiy 
specified. On DO, octal radix is the default for everything; the user may change the radix with the 
actions discussed below. 

The display mode for a value may be either numeric, search or symbolic. 

Numeric mode shows the value as a sequence of numbers (in the chosen radbc) separated 
by blanks; this is the default for all items. 

Search mode shows the value as an address symbol plus offset; this is illegal except for 
registers or memories that normally contain pointers into some other memory (e.g.. on 
DO search mode for CIA, TPC, APC, or CALLER shows the nearest IM address symbol 
less-than-or-equal to the value plus an offset). Search mode is not the default for any 
memory or register because it is slightly slower than numeric mode due to symbol table 
access and because more screen area is required to accommodate long address symbols; 
however, you may find search mode convenient for some of the items mentioned above. 

Symbolic mode results in a special procedure being called to print the value for the item; 
special procedures do not exist for any registers or memones on DO. 

When Midas thmks that the value in a register may have changed, it reads its value from the 
hardware and updates the display; the times when Midas does this are discussed later. Names are 
sometimes preceded by *, indicating that the value has changed, or by -. indicatmg that Midas 
was unable to read the value for some reason (e.g., the machine was runmng). For an item 
marked with -, the old value, which might be wrong, is displayed. 
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Once some register or memory address has been put into a name-value menu, various mouse 
button combinations over the name or value may be used to modify the way it is displayed, 
sequence through words in a memory, pretty-print the value on the comment lines, or show 
address equivalences. These are summarized in the table below: 

Buttons Name- field Value- field 

Left Examine Change value 

Middle Alternate printout Pretty-print value on comment lines 

Right A-Hl, A-1 menu Append value to input line 

Left -I- Middle Radix menu Radix menu 

Middle + Right Fill column menu Display mode menu 

When a button combination selects an alternate menu, the alternate menu will replace the 
standard menu while the mouse buttons are depressed; if you release the buttons over an alternate 
menu item, it will be executed; if you are outside the menu when the buttons are released, the 
standard menu will be restored and nothing will happen. 

The "A -Hi", "A-1" menu appears for memory addresses, but not for registers; these increment or 
decrement the memory address in the menu, displaying the successor or predecessor. The "FillC" 
menui allows you to examine successors (A -1-1. A -(-2, etc.) in the menus below the selected one; 
the whole column is filled with successors, if the input text line is blank; otherwise, the input text 
line is evaluated to a number N, and N lines are filled in with successors. The last address 
examined is left on the input text line, so you can iterate the examine and fill column actions to 
achieve scrolling. 

Releasing the lefi button over a value stores the value of the input text (or if no text typed) in 
the s<jlected register. For memories and registers whose values are displayed as several fields, the 
input text must also be divided into fields; omitted fields are zeroed. Each field may consist of 
numt)ers or memory addresses separated by +/-; expressions are evaluated using die radix for the 
item. 

Note: On DO and Dorado, IM memory words show an absolute address with eadi value; it is impossible to 
modify this address from Midas-the correspondence between virtual and absolute addresses can only be 
established by loading a microprogram. Several other items also have read-only fields that cannot be 
vmtten. as discussed later. 

Provision is made for special input evaluation based upon the register or memory; whenever the 
input text cannot be evaluated as a sequence of fields, the special input procedure (if any) is 
called. At the present time, special input procedures are implemented for registers and memories 
that contain microinstructions (IM, IMX, and MIM on DO) and for 16-bit registers. These are 
discussed later. 

Releasing the middle button over a value pretty-prints the value on the command comment lines. 
The Jiltemate for registers that normally hold IM addresses is the nearest IM address tag less-equal 
to the value 4- offset Registers and memories that contain microinstructions may also be printed 
symbolically. Other pretty-print information is detailed later. 

Releasing the right button over a value item appends the text of the value to the input text line. 
This is primarily used in command files, to move values from one register to another or to display 
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a memory address that is pointed to by the value in some other register. 



6. Command Menu 

The command menu holds a list of actions that Midas can execute. The basic menu is modified 
under some conditions. For example, the "Dump" menu item only appears after you have done a 
"Load". During execution, some actions show alternate menus. 

For all DO actions in the command menu, mouse buttons are equivalent Many common actions 
may alternatively be initated by keyboard command characters, as given in the action table below. 

Table 1: Command Menu Actions 



Input Char 

Actions (potentially) 

[File] 
[FUe] 



Menu Item 



Conunents 



available on all implementations of Midas 



Run-Prog 
Read-Cmds 

Show-Cmds 

Write-Cmds 

Load 

LdSyms 

Dump 

Compare 

Break 
UnBreak 
Go 
Continue 

Continue 
SS 
SS 
Test 

Test-AU 

Virtual 

Absolute 



Actions peculiar to DO Midas 



File 
Files 
Files 
[File] 

[File] 

Addr 

IMaddr 

[IMaddr] 

[IMaddr] 



[IMaddr] 
[IMaddr] 



;L 

;D 

:C 

;B 
;K 
:G 
;C 

;P 
•.s 



;Q 



Boot 

OrAddedBPs 

ClrAllBPs 

ShowBPs 

Exit 



Reset symbol table, breakpoint table, and display, then do Read-Cmds. 

Executes command file (def. ext "Jvlidas") on input text line or from 

submenu. 

Shows command file text for selected menu items. 

Write subsequent commands on File. 

Loads MB files (names separated by ","). 

Loads only addresses fi-om .MB files. 

# Dumps compacted JvIB file using the J^B file(s) of the previous load 
to control whafs dumped. 

# Compares hardware data to that in .MB file. 
Prints value of an address (illegal in com-file) 
Inserts break point 

Removes breakpoint (default address = last break). 

* Start at address (continue if nothing typed). 

• Start at address without lOReset or control section reset (continue from 
break if nothing typed). 

* (makes ";P" and ";C" synonymous) 

• Single-step at address (continue-step if nothing typed). 

• So ":'* and ";S" are synonymous. 

• Test register, memory, or other test with data pattern and item selected 
from submenus. 

Test everything. 

Changes IM address interpretation to be virtual 

Changes IM address interpretation to be absolute. 



Boots the DO and resets Midas as for Run-Prog 

Qears all breakpoints added since the last Load. 

Qears all breakpoints. 

Show BFs added since the last Load. 

Exits cleanly from Midas-" ;Q" and Shift-Swat are synonymous. 



• = requires preceding "TimeOut" action in command file 

# = requires confirmation with <cr>, "Y". or "." (or by preceding "Confirm" 
[...] = optional input text 



command in com-file) 
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Some actions in the preceding table are replaced with complementary actions after execution- 
these are Show-Cmds by Conceal-Cmds, Write-Cmds by Stop-Write-Cmds, Virtual by Absolute. 

General philosophy on mixing keyboard and mouse button control is that, when possible, a 
command involving some typing is carried out completely at die keyboard, whereas commands 
involving mouse buttons are carried out completely witii the mouse. 

For example, to start a microprogram at some address, you normally type an address; tiien you 
could bug "Go" in die command menu, but probably "address;G" is more convenient because 
you won't have to lift your hand from die keyboard; ";G" are the command characters equivalent 
to bugging "Go". 

Many commands are executed in overlays. When tiiese get executed, die register display will turn 
off (The code for overiays resides where die display bit buffers would odierwise be.). During 
loading or execution of command files, die display is turned off' to make die machine run faster. 

Long-running commands normaUy display an "Abort" menu item. When diis is bugged or when 
control-C is typed, die action terminates. 



7. Keyboard 

" = ", "+", "-", "#", and "!" are legal symbol constituents in microprograms but will cause 
trouble for Midas if diey appear in address symbols. "=" is an action character diat will 
prettyprint die memory name and offset and die nearest address symbol less-than-or-equal to die 
value of die string on die input text line. "+" and "-" have dieir usual sum and difference 
meanings in evaluating input expressions. "#" (octal). "!" (decimal), and "%" (hexadecimal) may 
be inserted anywhere in a number to overrule the default radix; e.g.. "#123" or "123 #" will 
force die evaluation of die number "123" to be in octal. The default input/output radix for 
everydiing on DO Midas is 8 (octal). 

Lower case typem is converted to upper case by Midas, so avoid lower case characters in 
microprogram address symbols. You should write microprograms widi die shift-lock key 
depressed or assemble diem widi die convert-to-upper-case assembly switch. 

Typing ahead is legal until die character you type would cause execution of an action. After diat, 
Midas will flush input and blink at you until the current action finishes. 

At die end of an action, input text typed for diat action is displayed on die input text line. This 
text remains valid and can be used as die arg for anodier mouse action. However, if you type any 
character (except control-A or backspace), die old mput will be flushed before inserting die new 
character. 
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Keyboard editing characters are as follows: 

control-A delete last character 

backspace delete last diaracter 

control-Q clear text line 

del clear text line 

Other special keyboard characters are as follows: 

control-C abort the current action-equivalent to bugging the "Abort" command (only defined for 

actions that display "Abort") 

control-Z abort a command file -ToctAiv^ 

escape repeat previous action (special for Test and TestAU ) 

return special foUowing "Test" or "TestAU" , ^, ^ 

control-D turns on the display (used during command mes) 

control-0 turns off the display (used during command files) 

shift-swat exit cleanly from Midas 

The interrupt characters above are ineffective during loading, dumping, or compmng, which 
typicaUy take between 2 and 20 seconds. Indefinite duration commands, such as Go . Test ,^ 
etc. always monitor the keyboard, so control-C can be used to terminate them. 

Control-Z, control-D. and control-0 are intended for use during command files However, these 
characters do not take effect until the command file executes a command such as Go which 
monitors tiie keyboard. There is no way to abort a command file and give control back to Midas 
safely except during a "Go" or other long-running command. This is not expected to be a 
problem because commands are executed quickly. 

After interrupting a "Go" with control-C or control-Z, proceeding with ";P" or ";G" will succeed 
except when you have smashed the machine state by writing a register or in some other way or 
have interrupted an instruction firom which continuation is impossible, 

Altiiough command menu items "SS." "Go." "Continue." "Break," and "UnBreak" are provided, 
the keyboard characters equivalent to tiiesc are usuaUy more convement 

8. Command Files 

Command files (default extension ".Midas") are normally executed either by typing "Midas 
filename" to tiie Executive or by bugging a file name in the subsidiary menus put up by Run- 
Prog" or "Read-Cmds". Alternatively, you may type a file name first, tiien bug o^^J^l}^^ 
actions (If you type a file name after tiie subsidiary menu is put up and tiien bug Abort , the 
command file will also be executed; it is not clear whetiier tiiis is a bug or a feature.). 

Hie names in these sub-menus are contained in the files Midas.Programs and Mi^,Uf^J^^/ ^fl ff 
S^Trh v^r^ Hrt of file names separated by blanks, commas, or carriage-returns. Midas.Programs is part of 
^e lid Mic^ ?e!e^ MiS^serProUs is an optional file that a user l^ic^ ^ ^gf^ .^fo 
his own stuff TTie names must be UPPER-CASE These lists serve two Purposes: buUdang file FPs to 
speed OpenFile. and preparing the menu items for "Run-Prog and Read-Cmds . 

If the file name contains no extension, then hint FFs will V«^*J;>^.\°^. ^f^, ^,t 
" name.MIDAS and name wiU be put in the "Run-Prog" menu. .(However, the hint F^s are n^ 
buUt unless the file exists, and the file name will not be put m the Run-Prog menu unless 
name-MIDAS exists). 
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If the name ends in "•", a quick OpenFile table entry is made for name.midas and the name 
will appear in the "Read-Cmds" menu. 

If the file name contains an extension, then it will be put in the quick OpenFile table, but won't 
appear in the "Run-Prog" or "Read-Cmds" menus. 

Since Midas builds a table of file FP's during its initialization, when you edit a command file or modify a 
.MB file, you should reinitialize Midas by typing "Midas/I". When you add new command files or .MB 
files you should update the "Midas.UserPrograms" file appropriately and do "Midas/I". 

"Read-Cmds" executes the actions stored in the command file; it is frequently used to modify the 
display in various ways by executing command files that show collections of items that are of 
interest 

"Run-Prog" first clears the symbol table and restores the display to its initial arrangement; then it 
executes the actions in the selected command file; "Run-Prog" is used to completely change 
contexts~to run a new microprogram, for example. 

Generally, there is one "Run-Prog" command file for each hardware diagnostic, with the same name as the 
diagnostic, e.g.: 

dgbasicjnb the diagnostic; 

dgbasicjnidas the command file. 

A command file following this convention loads the diagnostic into the miaoprocessor and displays various 
registers of interest when the miaoprogram is in use. 

The command-file facility is actually an (awkward and limited) programming language. The 
collection of actions discussed below is being developed so that command files can monitor 
diagnostic microprograms, collect and report error information on an output file, or du-ect die 
sequence of diagnostic microprograms according to hardware failures that are observed. 

For system microcode, command-files can be used to control auto-restart and failure diagnosis. 

Conmiand files can be nested witii "Run-Prog" and "Read-Cmds" subject to the following 
RESTRICTIONS: 

(1) [Maxc2 only] "AltIO" terminates command files (i.e., upon return to Midas from AltIO the 
command file wiU not be continued). 

(2) Nesting is limited to 8 levels (a parameter that could be increased if more levels are needed). 
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A number of actions, some of which cannot be given interactively, are useful in command files. 
These, not given in the table earlier, are shown below. The first table is for actions that operate 
on name-value menus (AO ... C19); the second table for command menu PQ actions. 

Table 2: Command File Name- Value Actions 



Text Arg 



Action 



Address 


Addr 


Value 


Val 




A+1 




A-1 


NCols 


FUlC 




Oct 




Dec 




Hex 




Num 




Sym 




Search 


Value 


SkipE 



Value 



SkipG 



Value 


SkipL 


Value 


SkipNE 


Value 


SkipLE 


Value 


SkipGE 



Comments 

Button actions as discussed earlier. 

Button actions as discussed earlier. 

Increment memory address, as discussed earlier. 

Decrement memory address, as discussed earlier. 

Fill name-value menus beneath the one selected with consecutive addresses starting at 

the address contained in the selected menu. 

Display address offset and value in octal 

Display address offset and value in dedmaL 

Display addres; offset and value in hexadedmal 

Display value numerically. 

Display value symbolically. 

Display value as an address symbol plus offset in the appropriate memory. 

Skip the next command if the input text evaluates equal to the contents of the 

register or memory word displayed. The input text is evaluated exactly as though it 

were to be stored into the register displayed in that name-value menu, so if the 

value displayed has several fields, the input text must also have several fields. 

Skip if input text greater than the contents of the item in the name-value menu 

(unsigned compare). 

Skip if input text less than name-value iton. 

Skip if input text unequal to name-value item. 

Skip if input text less than or equal name-value item. 

Skip if input text greater than or equal to name-value item. 
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Text Arg Action 



Octal no. 
.Tag 

Octal no. 
.Tag 
Octal no. 



Octal no, 



JFUe name 
.File name 

[text] 



Skip 

Skip 

BackSkip 

BackSkip 

Return 

DispIayOn 

DisplayOff 
TimeOut 



Confirm 

OpenOutput 
AppendOutput 
QoseOutput 
WriteMessage 



text 


WriteDT 
ShowError 


text 


DumpDisplay 
PrettyPrint 


File name 


WriteStatc 



Table 3: Command File Command Actions 
Comments 

Skip N following commands, where N is the value of the input text 
Skip following commands until one is encountered with the label ".Tag". 

Reset to byte 1 of the conmiand file, then skip. 

Return out of current command file, then skip (".Tag" form is illegal for Return.). 
Turn on the display, so that effects of subsequent commands can be observed. The 
display is initially off for a command file. 
Turns off the display. 

Input text is evaluated to a 32-bit octal number of msec at which to abort the 
immediately following command, if it has not finished by then. This is intended for 
use before "Go" and other commands which might hang indefinitely. If the timeout 
occurs, Midas will skip the command after the "Go". TimeOut also turns on the 
display, necessary because the machinery which checks for timeout is only active with 
the display on. Note that TimeOut is required before the actions ''ed in the table 
on page 4 and is illegal before other commands; Midas will complain if you do not 
use TimeOut appropriately. 

Supplies confirmation for the command which follows (whidi should be one of the 
commands requiring confirmation). 

Opens an output file (default extension ".Report") on which text can be written. 
Append to an output file (default extension ".Report") 
Qoses the ou^ut file. 

Writes the contents of the input text buffer on the output file. Note that if any text 
follows the WriteMessage, that text up to but not including the <ct> is what gets 
written. However, if <cr> immediately follows WriteMessage, then the contents of 
the input text buffer left by the previous command get written. "~" is translated 
into <CT> and "\" into a blank. 
Appends the current date and time to the (xitput file. 
Displays the text arg on the command line, turns on the display if it was off. and 
queries with "Abort" and "Continue" menu items. 
Writes the current display image on the output file. 
Evaluates text to a memory address, register name, or memory name; writes this 
name on the ouq)ut file; then pretty-prints the value on the output file exacUy as it 
would be pretty-printed on the comment lines if the item were displayed in one of 
the name-value menus and middle-buttoned. 

Used by Midas initialiiation to create the Midas.Dtach and Midas.RunProg files- 
users shouldn't use this action. 



9. Syntax of Command-file Actions 

The syntax of a command-file action is as follows: 

[["."<tag>]$" "]<buttons>$" "<menu>$" "<action>{$" "<text>][";"<comment>Kcr> 

where ilie "Q" denote that the ".tag", input text, and ";comment" are optional. $" " denotes a 
sequence of one or more blanks and tabs. 

If the first character on the line is a ".", then the characters after that are a label or tag which may 
be used as the argument for the "Skip" or "BackSkip" actions given in the table earlier. 

<buttons> may be any combination of the letters "L" (left-button), "M" (middle-button), and 
"R" (right-button); these are the buttons released to execute the action. These may appear in any 
order. 
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<menu> is the menu name in which the action is executed ("X" for the command menu, 
"A0"..."A19", "B0"..."B19", and "C0"..."C19" for name-value menus). 

<action> is the text name for one of the actions (upper/lower case must match the definition). 

<text> is the text typed on the conmiand line, which may be anything except a ";". 

Note that if a single blank terminates <action> and if no input text argument is given, then input text left- 
over from the preceding action will be used. This aUows text from a right-button action over a value to be 
used in a following action (e.g.. in WriteMessage or to store the value into another reigster). However, one 
or more extra blanks wiU reset the input text, so the action is executed with nuU mput text 

";" begms a comment, which may be omitted. 

<cr> (camage-retum) terminates the action. 

To find out what text should be put in command files, you can bug "ShowCmds" in the 
command menu. This will cause the command file text for each command to be displayed on the 
command comment line as the mouse selects it (You don't have to execute the command to see 
the equivalent text). This text is complete except that the mouse button which executes the 
command isn't shown unless you depress the mouse button. To terminate "ShowCmds", bug 
"StopShow" (which appears only when "ShowCmds" is in progress.). 

You can prepare a command file (default extension ".Midas") by typing a file name and bugging 
"Write-Cmds". This causes text for subsequent commands to be put on the file. When you are 
done with this, bug "Stop-Write-Cmds" to close the file. ("Stop-Write-Cmds" is in the command 
menu only when a command file is being written.). Exiting firom Midas also closes the output file. 

You will probably want to edit out your goofs mHi Bravo after the command file is written. 

In addition, you will have to insert "Confirm" before actions which requke confirmation and 
modify the "TimeOut" stuff which Midas uses to surround actions which might hang indefinitely 
(See the table given earlier for the actions that require this.). 

Here is a sample command file: 

L X Load DGl- Equivalent to typing "DGl" and bugging "Load" in the command menu 

L AO Addr CTASK; Examine the "CTASK" register in name-value menu AO 

L AO Val 0", Change the value in CTASK to 

L Al Addr RTEMP: Examine the address "RTEMP" in menu Al 

L AlSkipEFOO+3; Skip the next command if RTEMP contains the value F004-3 

L X ShowError RTEMP not loaded correcUy 

L A2 TPC 0; Examine the TPC register for task in menu A2 

L X TimeOut 2000; Abort the following command if it hasn't^ finished in L024 sec. 

L X Go START; Begin microprogram execution at address "START" 

L X Skip 1; ' Skip the next command if "Go" halts before timeout 

L X ShowEiror START;G failed: Show an error message 
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10. Registers and Memories Known to Midas 

Table 4: Memories 



Memory 
IM 

mix 

RM 
T 

TPC 
VM 

MAP 

BP 

MIM 

MDATA 

MADDR 



Width 


Length 


Noi 


(octal) 


(octal) 




100 


10000 




44 


10000 


4.5 


20 


400 


4.5 


20 


20 


1 


20 


20 


1.2 


20 


2^ 


4 


20 


2l4 


4 


100 


402 


3 


60 


1000 


3 


und 


10 


3 


40 


20 


3 



Comments 

Control store (virtual). 
Control store (absolute). 

Primary task-specific temporary register. 

Task-specific subroutine return link. 

Main storage (addressed through the MAP) 

Maps VM to absolute storage. 

Breakpoint information used by Midas. 

Holds microinstructions used by Midas. 
BITS-CHECKED etc. for testing. 
LOOP-COUNT etc. for testing. 



Task-specific register 

Virtu^absohite stuff applies 

Fake memory-artifact of stuff in Midas 

Appears in Test menu. 

Appears in TestAll menu. 



Table 5: Registers 



Register 


Width 


Notes 


Comments 






(octal) 










APCTASK 


4 




Next 


task 




APC 


14 


2 


CXirrent task's subroutine return link or next task's PC. 


CTASK 


4 


3 


Task 


for 


which 'T 20" and "TPC 20" apply. 


CIA 


14 


2 


Current instruction address. 


CYCLECONIROL 


10 




See HW manual 


PAGE 


4 




Current IMX page. 


PARITY 


4 


1 


See 


HW 


manual 


BOOTREASON 


10 


1 


See 


HW 


manual 


PCXREG 


4 




See 


HW 


manual 


PCFREG 


4 




See 


HW 


manual 


DBREG 


6 




See 


HW 


manual 


SBREG 


6 




See 


HW 


manual 


MhfBR 


20 




See 


HW 


manual 


ALURESULT 


4 




See 


HW 


manual 


SALUF 


10 




See 


HW 


manual 


SSiKP 


10 




See 


HW 


manual 


STKP 


10 




See 


HW 


manual 


MEMSYNDROME 


20 




See 


HW 


manual 


CALLER 


14 


2 


Shows contents of APC-1. (address of last subroutine call); 
cannot infer this firom APC in virtual mode. 


AATOVA 


20 


3 


Translate 


absolute address to virtual 



1. Read-only to Midas. 

1 Virtual/absolute stuff applies 

3. Fake register-artifact of stuff in Midas 



Most registers and memories listed above correspond to ones discussed in the "DO Hardware 
Manual". Others are discussed in the sections which follow. 



MDATA and MADDR memories contain words used to report or control the activity of the 
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"Test" and "Test- AU" actions discussed later. MADDR also contains COMM-ERO, COMM-ERl, 
C0MM-ER2, and BOOT-ERR (error-reporting), which will be discussed later. 

The BP and MIM memories are not expected to be of interest to programmers. BP holds the 
information about breakpoints that is manipulated by the breakpoint actions discussed later. MIM 
holds microcode overlays that are written into the DO microstore to operate the hardware. 

' For approximately all registers and memories that contain 16-bit quantities, Midas will evaluate 
input of the form "m„n", storing the value of "m" into bits 0:7 of the word and the value of "n" 
into bits 8:15. 

On DO. the items that accept "m.,n" are RM. T, VM, MAP. and MNBR. 

11. The IM Memory and Virtual Addresses 

Because the placement transforaiations performed by MicroD make it difficult to correlate 
microstore locations with positions in microprogram source files, the Dorado and DO Midas 
implementations use a map to transform virtual addresses produced by Micro mto absolute 
microstore locations produced by MicroD. 

Two memories, IMX and IM, each show the microstore. IMX is absolutely addressed; IM 
virtually addressed. When you fire up Midas, IM is "empty"; when you load a microprogram, IM 
is filled with consecutive instructions firom your source file, irrespective of where MicroD decides 
to place these; the "value" displayed for an IM word includes both the absolute address assigned 
to it and the microinstruction. 

In other words, if your microprogram is 10 words long, the meaningful part of BVi is only lO^o^'J l°i* 
In this case, if you examine IM addresses greater than 7. the printout will show an absolute address of 7777 
and zeroes for the rest of the value. 

Midas will not allow you to modify the mapping between virtual and absolute addresses interactively-you 
can only do this by loading a microprogram. 

To facUitate dealing with virtual/absolute correspondences, Midas has a mode switch that controls 
handling of registers and memories that normally contain microstore addresses. When you fire up 
Midas the display is in absolute mode and the "Absolute" action appears in the command menu; 
when 'you load a microprogram, the display switches to virtual mode and the "Vutual" action 
appears in the command menu. Test actions will switch to absolute mode. The current modQ 
always appears in the command menu. 

In virtual mode, the display shows the virtual equivalent for the value m any register that 
normally contains a microstore address. When the value is outside the virtual memory, it pnnts as 
7777. To find the absolute value in this case, you have to switch to absolute mode. 

On DO the registers affected by this are TPC. APC. CIA. and CALLER. 

The general idea is that, if you suspect a hardware problem in the control section, you might work 
in absolute mode, but in aU other situations when a program is loaded you will work m virtual 
mode, and the complications created by scrambled instruction placement will, be concealed. 

A fake register caUed AATOVA converts absolute addresses to virtual. For example, copying the 
value in some RM word into AATOVA will show tiie virtual equivalent; tiiis is useftil when 



DO Midas Manual Edward R. Fiala 3 January 1980 17 

return links are saved in RM words. 

Hie convenient way to use AATOVA is to first right-button the value from an RM word that contains a 
return link (which puts the value on the input text line); then left-button the value into AATOVA, which 
will prettyprint the virtual address on the comment lines. 

12. Registers and Memories that Contain Microinstructions 

Tlie DklX, IM, and MIM memories all contain microinstructions. A middle-button action over the 
value will print these symbolically on the comment lines. 

The value for an IM word is shown as four fields on the display: 

14g-bit absolute address; 
bits 40-43g of microinstruction; 
bits 0-17g of microinstruction; 
bits 20g-37g of microinstruction. 

The format of the bits is as shown in the hardware manual. You will note that the RSEL and JA 
ilelds are scrambled in this arrangement; each of these has two bits in the main part of the - 
microijttstruction and two other bits in the 4-bit extension, and two of the RSEL bits are inverted. 
This, together with the numerous fields in each microinstruction, makes octal interpretation and 
modification of microinstructions somewhat tedious, so the symbolic pretty-print and input forms 
discussed below should generally be used. 

IMX iand MIM are like IM, but the Mg-bit absolute address field is absent fi-om IMX. 

The M[IM memory is an array in Alto core that contains microinstructions used by Midas when 
operating the hardware; it should ordinarily be of no interest to users. 

Note that tiie microinstruction pretty-print procedure does not have available all of tiie 
information tiiat the microassembler had when you assembled your program, so tiie printout is not 
always beautifiil. The following are deficiencies you should be aware of: 

From tiie hardware manual, you will remember that the interpretation of some 
instruction fields depends upon the task executing tiie instruction, so Midas will 
disassemble correctiy only when it is able to deduce tiie task tiiat executes tiie 
microinstruction. 

Tliere are many possible assembler macros tiiat you might use to generate constants to 
control tiie shifter; for an instruction tiiat does tiiis, Midas might not choose tiie form 
you used in tiie source file. 

When you want to modify a microinstruction, a special form of input is available as follows: The 
first character on tiie input text line should be "(" to change tiie values of several fields in tiie 
instruction witiiout clobbering otiier fields, or "[" to reconstruct tiie value beginning witii a no-op 
microinstruction. This is followed by a number of clauses of tiie form "Fields integer" separated 
by blanks and/or commas. The legal field names are: 

RSEL, JA, MEMINST, F2, and JC for all instructions; 
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RMOD, ALUF, BSEL, Fl, LR. and LT for regular instructions only; and 
DF2, TYPE, and SRCDEST for memory instructions only. 

In addition to "fields-value" clauses, Midas interprets the standalone clause RETURN, and branch 
clauses of the form GOTO[addr], CALL[addr]. GOTO[addr,bc], GOTOP[addr], or CALLP[addr]. 
In these "addi" is interpreted as a virtual IM address in virtual mode or as an absolute IMX 
address in absolute mode; "be" is a symbolic branch condition. 

The "addr" argument to GOTO, CALL, GOTO?, and CALL? will usually be a simple integer in 
absolute mode but may be an expression such as FOO+3, where FOO is an IM address, in 
virtual mode. Midas will give an error if tiie target for GOTO or CALL is off-page; in tiie event 
that an off-page branch is legitimate because tiie predecessor did a LOAD? AGE, tiien tiiis error 
check will tiiwart you-you have to use GOTO? or CALL?, which do not check for off-page, in 
this situation. 

On a conditional GOTO, Midas will check tiiat tiie target is at an odd location for a "regular" 
branch condition, or at an even location for an "inverted" branch condition. The branch 
conditions are as follows: 

Regular: ALU#0, CARRY. ALU<0, NOH2BIT8. R<0, ROOD. NOATTN, MB, 
INTPENDING, NOOVF, BPCCHK, SPARE, QWO. and TIMEOUT; 

Inverted: ALU=0, NOCARRY, ALU>-hO, H2Brr8, R>=0, REVEN. lOATTN. 
NOMB, NOINTPENDING, OVF. NOBPCCHK, NOSPARE NOQWO, and 
NOTIMEOUT. 

For parts of tiie microinstruction otiier tiian the control clause. Midas requires you to use tiie 
awkward "field^value" form. 

13. Task-Specific Registers 

Midas treats all task-specific registers (T and TPC) as 20-word memories. In otiier words, "T 6" is 
tiie T-register for task 6. 

In addition, a special kludge allows you to display tiie 21st word (i.e.. "T 20" or "TPC 20") and 
have tiiat be interpreted as tiie register for the currently selected task. The currentiy selected task 
is tiie value in CTASK; CTASK is initialized to tiie task which broke at breakpoints. 

In otiier words, when a microprogram halts at a breakpoint or because of a mouse-abort, CTASK 
becomes tiie word number for tiie "T 20" and "TPC 20" items on tiie display; if CTASK contains 
6, tiiese will show values for task 6. You can see tiie registers for anotiier taks by modifying 
CTASK on your display. CTASK is also tiie task started by "Go", "SS", etc. as discussed later. 

APC contains eitiier tiie subroutine return link for tiie current task or tiie PC for a task about^ to 
be reactivated; when it is a subroutine return link, it holds tiie location of tiie last CALL or'ed 
witii 1. In virtual mode, because of tiie scrambled instruction placement, tiiis will not readily 
translate into tiie location of tiie caller, so Midas provides a variant of APC named CALLER, 
which holds tiie value in APC less 1; in virtual mode tiiis will show tiie IM address of tiie last 
CALL. 
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14. Memory System Registers and Memories 

VM accesses the virtual memory using the current contents of the MAP. Midas does not provide 
any direct method of accessing storage; the user has to setup MAP with appropriate values and 
then use VM to do this. 

MA]^ MEMSYNDROME, etc. to be filled in 

15. Loading Programs 

The "Load", "LdSyms", and "LdData" actions are used to load micro-binary files into the 
macliine. These actions are executed by first typing a list of file names (default extension ".mb") 
separated by commas, then bugging "Load" or "LdSyms" (typing ";L" is equivalent to buggmg 
"Load"). These actions require confinnation by <cr>, "Y", or "." iff a previously-loaded 
program is being overwritten; in a command file where it is not known whether or not another 
program is being overwritten, a "Confirm" action should precede the load action, as discussed 
earlier. 

"Load" loads the entire jnb file-symbols into the Midas symbol table, data into die hardware, 
and breakpoints into the BP memory. 

"LdfJyms" loads only the address symbols and IM mapping table from die .mb file; die BP 
memory is not loaded and data are not loaded into the hardware* 

"LdlData", (in command files but not available interactively), loads data blocks and die BP 
memory from die .mb file; symbols and die IM mapping table are not loaded. 

On DO, the MADDR and MDATA memories are treated as exceptions by "LdData"-symbols for these are 
loaded anyway. 

Midjis uses several 1024-word core buffers (about 12 on DO Midas) and die Swatee file to manage 
its s;yTiibol table and virtual memory mapping information; the largest existing programs use 10 
buffers for VM information and about 20 more (out of 64 available on Swatee) for symbols. For 
nearly all symbol and VM accesses, Midas will reference only one or two symbol blocks, so there 
should be no appreciable slow down when handling large programs. 

The symbol table management algorithm used by Midas is an extremely fast merge that works well when 
the symbol table is neariy empty at the on«t of a load but suffers somewhat from block fragmentation 
when the initial symbol table has many items. 

To avoid fragmentation, don't load one micrc^rogram on top of another~use "Run-Prog" to reset the 
symbol table, then do the "Load". It is also a good idea to assemble microprograms as a single .MB file. 
Although Midas can load multiple .MB files (typed as a list separated by commas), this will fragment the 
symbol table and cause extra thrashing. 

These recommendations follow because Midas takes advantage of alphabetical address ordering in .MB files 
to pack its symbol buffers nearly fiiU. But when subsequent files are loaded, the symbol buffers will 
fragment to about half-full, symbol buffer swapping will result, and symbcri searcha will be longer. 

Midas uses the symbol table in two ways: looking up the value of a symbol, requiring at most one disk 
access; and searching for the symbol in a particular memory which best matches a value, requiring at most 
one access for RM or at most two accesses for IM address symbols; the best matching value for addresses in 
all other memories is detemiined by scanning every block. Searching every block requires about (.22 
seconds' * no. symbol blocks) - (.15 seconds * no. blocks in core) or about 2.9 seconds for the largest 
program thus far. However, since best matches for the two most important memories are obtained quickly. 
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it will rarely be necessary to wait for a search. 

In most simations where a "Load" is going to be done, many other actions will also be carried out 
to setup the display appropriately for the program. For this reason, you will ordinarily want to 
define a command file that does all these other actions as well as the "Load" and you will 
ordinarily do "Run-Prog" on this command file; direct use of "Load" in the command menu will 
be rare. 

Midas/MicroD do not handle microprograms with overiays conveniently. At present, the system 
microcode consists of an initial microstore image that contains both some resident code and 
initialization code; the initialization code is executed and then overwritten by the rest of the 
resident system. Midas/MicroD do not provide any clever features for setting up the symbol table 
and IM mapping table correctly in this situation. One method of handling this situation is to 
create a "Run-Prog" command file which does the following: 

1) A "Load" on the resident -f initialization; then a "Go" at the starting address, which 
runs up to a breakpoint at the end of initialization. 

2) A "Run-Prog" on anotiier command file; tiiis clears die breakpoint, IM mapping, and 
symbol tables. The command file does a "Load" on the original resident -H rest of 
resident that replaces the initialization code and returns to the outer conmiand file. 

3) A "Go" at tiie starting address (or a "Continue" from the initialization breakpoint) to 
start the system which then runs until it fails or halts. 

Assuming tiiat you are somehow able to build the two .Mb files needed by this sequence (It is 
unclear how you will do this.), you will wind up with Midas containing the correct symbols and 
IM mapping table for debugging. 

16. Dump and Compare 

Botii "Dump" and "Compare" require confimation by <cr>, Y, or "." They accept the name of 
a microprogram (default extension "jnb") on the input text line. If tiie input text line is empty, 
then tiie file name is defaulted to die name of die program last loaded. 

"Dump" deletes forward reference fixups left by Micro (which never occur on Dorado or DO 
because MicroD does tiiese) and compacts both data and addresses to use less disk space and load 
more quickly later. Dumped files are about 20% smaller and can be loaded 10% to 15% faster 
than undumped files, so it is desirable to load and tiien dump .mb files tiiat will be used widely. 

Also, if undumped .MB files contain forward references, tiiey cannot be used witii "Compare" (no 
problem on Dorado or DO). 

Note that only memory words loaded by Load are dumped-you cannot patch unused locations, 
dump tiie program, and expect die patches to survive. (You might assemble extra locations as a 
patch area witii your microprogram, so tiiat you can patch and dump during debugging, but 
placement constraints will be difficult to satisfy.) 

"Compare" compares data currentiy in storage against data in the file and reports differences on 
the Midas.Compare file. 
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U microprograins, avoid loading initial values into memory words modified during execution. The 
usefulness of "Compare" is enhanced when programs are clean, because no fictitious errors will be reported. 

For diagnostics, "Compare" can report what has been smashed when something goes off the deep end--this 
lias fi-equently been helpfiil. 

]=^oUowing system microcode crashes. "Compare" may provide the only clue about the nature of an 
intermittent storage failure. 

17. Break, UnBreak, ClrAddedBPs, ClrAlffiPs, and ShowBPs 

"Breiik" inserts a breakpoint in the IM or IMX address typed on the input text line. The address 
must be typed-there is no default break address. You will normally find it faster to type 
"add]ress;B" to insert a breakpoint 

"UnBreak" removes a breakpoint If no text is typed, the address defaults to the breakpoint that 
caused the last program halt or to the address of the last breakpoint inserted. You will normally 
find it faster to type "address;K" or ";K" to remove a breakpoint 

"CkAddedBPs" removes all the breakpoints inserted since the last "Load" and prettyprints the 
addresses of the first 10 removed. "ClrAUBPs" clears all breakpoints, including those that were 
loaded witht he program. "ShowBPs" prettyprints the addresses of all breakpoints added since the ' 
last "Load." 

Breakpoints are implemented by replacing the broken instruction by a special breakpoint 
instruction. When the DO is halted, IMX contains the unbroken instructions, and Midas 
remembers which places contain breakpoints; when you continue your program with "SS," "Go," 
or "Continue," Midas saves the instructions in its table (the BP memory), and stores breakpoint 
instructions at those places; when the program halts, Midas restores die contents of IMX. 

Singli^stepping is also implemented with breakpoints; Midas determines one or both possible 
succeissors to the instruction being single-stepped, plants breakpoints there, starts the machine, and 
then undoes the breakpoints after the machine halts; BP*s and 1 are used for this purpose. 

A bn^point can be put on any instruction. However, there is a limit of 254 user breakpoints; 
also, ithere are some restrictions on continuing discussed in a later section. You may be unable to 
continue from breakpoints on some instructions. 

18. Go, SS, and Continue 

These are actions tiiat result in die microprocessor resuming or starting execution at the selected 
address. "Go" and "SS" accept an optional address argument on the input line that must evaluate 
to an IM or IMX address; a simple number is defaulted to an IMX address in absolute mode or 
an IM address in virtual mode. If the optional argument is omitted, Midas will continue from the 
last break. "Continue" always continues from the last break, ignoring any text on the input text 
line. 

The keyboard equivalents for these commands are ";G" for "Go"; ";S" or ":" for "SS"- and 
";P" or ";C" for "Continue." 

When you start at a new address, die value in CTASK (lower left-hand comer of the normal 
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display) is the task activated. You must change CTASK on the display before initiating execution 
for a different task. 

When the microprocessor halts after a breakpoint, due to an error, or because you aborted, Midas 
prints the location of and reason for the halt and saves the information tiiat it needs to continue. 
The form of the printout is "task: address". Subsequently, if you attempt to continue, Midas 
restores tiie hardware as nearly as possible to its state at tiie break before continuing. 

There are some complications surrounding Midas' ability to restore the state of die program, after 
doing other tilings, so tiiat continuation is possible. These are discussed in tiie next section. 

19. When Registers are Read/Written-Restrictions on Continuing 

When a microprogram halts at a breakpoint or due to a mouse-halt, Midas has two objectives: to 
read tiie contents of registers and memory addresses so tiiat tiiey may be shown to tiie user, and to 
be able to continue from die interrupt or breakpoint In terms of how die Midas read/write 
procedures work, there are tiiree cases: 

Registers: The Kernel program running on DO saves registers in RM words reserved for tiie^ 
purpose; Midas reads tiiese special RM locations into a block of Alto storage when tiie machine 
halts or when you do a "Boot" action. Subsequentiy, Midas displays tiie values from Alto storage, 
and, when a register is written, modifies the Alto storage. The DO hardware is not affected by any 
change in register values until you resume or start your DO program. At that time, tiie block of 
Alto storage is rewritten into tiie Kernel's special RM locations, and tiie Kernel will transfer tiiese 
values into tiie registers just before releasing control to your program. 

Memories: IM/IMX, RM, T, TPC, MAP, and VM addresses are read and written directiy; 
whenever you modify a word in one of tiiese memories, Midas will write it (tiirough tiie Kernel); 
Midas always reads tiie values from tiie hardware, never from remembered values in Alto core. 

Artificial registers and memories: For CTASK, AATOVA, BP, MIM, MDATA, and MADDR, 
Midas modifies/reads tiie Alto storage containing tiie value, so tiie DO hardware is not affected. 

However, whenever any register, memory word, or artificial register or memory word is modified, 
Midas rereads tiie value for every item on tiie display, going left-to-right and top-to-bottom 
tiirough tiie display. This is unimportant as long as the DO hardware is ftinctioning correctiy, but 
if tiie hardware is unreliable, tiien displayed values of memory words may change, so be wary. 

There are a number of situations tiiat may prevent continuation from a breakpoint or interrupt; 
Midas warns you about some of tiiese when you try to continue but does not warn you about 
otiiers. Some of tiie ones tiiat Midas does not warn you about are as follows: 

Input/output tasks were not serviced properly due to the delay at the breakpoint, so these are not continued 
correctly; 

You break on any of the three instructions involved in the "bypass kludge." when the instruction after a 
memory operation expects to read the result of the memory addition instead of the value for which write is 
pending into T or RM. 

Some situations tiiat Midas does warn you about are as follows: 

You broke at the instruction after a LoadPage. This happens either because you break on the instruction 
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Jifter a LoadPage or because you break on the LoadPage instruction itself and Midas breaks on the 
instruction after the LoadPage when restarting. 

20. Hardware Failure Reporting 

Midas checks for several kinds of hardware errors and reports them in COMM-ERO, COMM-ERl, 
and C0MM-ER2, which are addresses in the MADDR memory; these are shown in the upper 
right-hand name-value menus of die normal Midas display. Values have two 16-bit fields; each 
field counts errors of some type and can be prettyprinted for interpretation. Midas does not print 
any special messages after these errors-the user will have to notice when they change. 

A "Boot" action is carried out by first loading selected IMX words fi"om a ROM; Midas can cause 
the DO hardware to do this tiirough its Diablo Printer interface, as discussed in the hardware 
manual. When tiiis part of die boot finishes, Midas transmits the Kernel into IMX by 
comniunicating with the boot loader. If Kernel transmission is successful, Midas then starts the 
Kernel. 

Four possible communication errors may be detected during Kernel transmission. If one of these 
failures occurs, Midas reports the failure in BOOT-ERR (an address in the MADDR memory) and 
reattempts the boot, not giving up until the boot has failed 10 times. BOOT-ERR is shown on the' 
display as two 16-bit fields; the left-most field shows how many words were transmitted before the 
(last) failure occurred; the right-most field contains four four-bit nibbles that count die number of 
failure occurrences for each of the four reasons. 

As soon as the Kernel has been successfiilly transmitted, Midas will attempt to start it running; if 
this fails Midas will immediately report a failure without retrying. 

ME^[SYNDROME and BOOTREASON registers report failures detectd by the DO hardware, as 
discussed in the hardware manual 

21. Testing Directly From Midas 

"Test" and "TestAU" allow the target machine to be tested directly fi-om Midas. Although 
diagnostic firmware can test faster and more thoroughly tiian is practical firom Midas, Midas direct 
testing permits the hardware to be checked out well enough to get basic diagnostics loaded and 
started. On Maxcl, which had no direct testing in Midas, many hardware failures of the "nothing 
works" variety were harder to fix tiian on Maxc2 and Dorado, where Midas test software is 
availaible. 

However, on DO and M68 implementations of Midas, die test features in Midas are of doubtfiil 
usefialness because the hardware is accessed through communication with a small "Kernel" 
micrciprogram that only works when most of the hardware is functional. 

On DO, only IMX and RM are presentiy testable, but die address ranges are limited so as not to 
overvnite die parts of diese memories used by the Kernel. Neither of these actions is expected to 
be useftil because most failures in these memories will prevent die Kernel firom running. They 
are described here anyway. 

Data patterns for test actions are determined from the first subsidiary menu, as follows: 
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ZEROES 
ONES 

SHOULD-BE 
CYCl 

CYCO 

RANDOM 

SEQUENTIAL 

ALTZO 

ALT-SHOULD-BE 



Table 6: Test Data Pattern Actions 

All-zeroes data 

All-ones data 

Constant test pattern equal to value in SHOULD-BE 

Vector of the same size as the register containing zeroes with a single one-bit cycled left 

one position each iteration 

Cycled zero in vector of ones 

Random numbers 

0, 1, .... sequential numbers 

Alternating all-ones and all-zeroes patterns 

Alternating contents of SHOULD-BE with its ones-complement 



The CYCO, CYCl, and SEQUENTIAL patterns vary according to the size and arrangement of the 
data vector for the item being tested. CYCO, for example, starts off with leading I's and a in 
the right-most bit of the data vector. The is shifted left (bringing in I's to its right) each 
iteration; when the is shifted out of the left-most bit in the data vector, the vector is remitialized 
to leading I's and a m the right-most bit The CYCl pattern is like CYCO with I's and O's 
interchanged. The SEQUENTIAL pattern is initialized to and is incremented by 1 in the right- 
most bit of the data vector each iteration. 

This treatment of CYCO, CYCl, and SEQUENTIAL patterns is conceptually correct for items that 
are described inside Midas by dense, left-justified data vectors whose bits are displayed left-to-' 
right on the screen. On DO all testable items are handled this way. 

Testing is controlled/described by 12 addresses on the display as follows: 

Table 7: Test Items in the Name- Value Display 

SHOULD-BE On a failure, the correct data; after control-C or Abort, the next pattern. 

DATA-WAS On a failure, what the data was; after control-C or Ab(Mt. the data read last time. 

BITS-CHECKED Mask of bits checked (see below). 

BITS-PICKED Union of bits that should have been but were erroneously 1 during testing. This 

accumulates Mure information when you continue a Test using <escape> or <cr>. 
BITS-DROPPED Union of bits that should have been 1 but were erroneously 0. 

LOOP-COUNT 32-bit iteration count at which feilure occurred or after ^^ch the test was aborted. 

NFAILURES 32-bit count of test feilures. 



Memory tests only 

LOW-ADDR 
HIGH-ADDR 
CURRENT-ADDR 
ADDR-INC 



ADDR-INTERS 
ADDR-UNION 



32-bit addresses: If ADDR-INC (normally 1) is positive, the test starts at LOW-ADDR 
and advances through the memory in steps of ADDR-INC until CURRENT-ADDR is 
greater than HIGH-ADDR. If ADDR-INC is negative, tiie test starts at HIGH-ADDR 
and goes by steps of ADDR-INC until CURRENT-ADDR is below LOW-ADDR. 
CURRENT-ADDR contains tiie last address tested. 
Intersection of address bits where failures were detected. 
Union of address bits where failures were detected. 



SHOULD-BE, DATA-WAS, BITS-CHECKED. BITS-PICKED, and BITS-DROPPED are 
addresses in the MDATA memory; LOOP-COUNT, NFAILURES, LOW-ADDR. etc. are 
addresses in the MADDR memory. These two memories (which are tables in Alto storage) exist 
on all versions of Midas that implement the test actions. 
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The handling of the MDATA memory is complicated by the fact that items in this memory have 
to be shown in the same format as the memory or register being tested. This is accomplished as 
follows: When the selected test item is different from the last, the width and print-format of 
MDATA are set to be identical to the new item; in this case BITS-CHECKED is initialized to test 
all bits in the new item. Then when the test is aborted or halts due to a failure, the display of 
BITS-CHECKED, etc. is identical to that of the item tested. The user may then modify BITS- 
CHECKED and continue, restart, or free-run the test, as discussed below; in this case the item 
tested is identical to the last item tested, so BITS-CHECKED is not reset 

The himdling of MADDR is also tricky. ADDR-INC is allowed to be any value except 0; if it is 
0, Midas will reset it to 1 before testing. When HIGH-ADDR is initially greater than tiie largest 
legal address in the memory, it is reset to memlengtii-1 prior to testing. Then if LOW-ADDR is 
greater tiian HIGH-ADDR, it is reset to before testing. When tiie selected memory differs from 
the last item tested, and when the lengtii of die memory is less-tiian-or-equal to lOOOOg words 
long, Midas will reset LOW-ADDR to and HIGH-ADDR to memlength-1 prior to testing. This 
is done because a common operational error is failure to reset the address range when switching 
from one memory test to anotiier. However, Midas does not reset the address range for very long 
memories because they are normally tested with small address ranges that cannot be predicted in 
advance-full-length testing of long memories from the Alto is so slow as to be impractical. 

"Test", after showing the data-pattern menu, shows a menu of register and memory names and 
other test names, and executes a test of the one you select until the test fails or you halt tiie test 
from the keyboard. 

The testable registers and memories appear in tiie second sub-menu for the "Test" action. 
Provision is also made for other machine-dependent tests, but there aren't any implemented for 
the DO. 

<esc> will continue a register or memory test that has halted; it restarts an OtiierTest tiiat has 
halted, 

<cr> will continue a register or memory test that has halted but will free-run the test rather than 
halting on tiie next failure. While free-running, LOOP-COUNT and NFAILURES are reported 
continuously on tiie display, and BITS-DROPPED, BITS-PICKED, ADDR-INTERS, and ADDR- 
UNION accumulate failure information. When you stop the test by bugging "Abort" or typing 
control-C, the accumulated failure information is displayed in these registers. 

"Test^Lll" automatically loads BITS-CHECKED with a full-sized comparison mask prior to testing 
each item; memories are tested witii LOW-ADDR = 0, HIGH-ADDR = memory length-1, and 
ADDR-INC = 1. It tests each register 200 times and makes 4 passes through each memory and 
each OtherTesL 
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22. Command FUes Used With "RdCmds" 

At the time this was written, the following command files were in use: 

Table 8: Command Files 

midas-tests restore "noimal" Midas display with the hardware testing items in the right display column, 
svcrash write the Midas display followed by a pretty-print of most registers on the file Crash.Report 

tpc show 20g TPC registers in middle coluzrm. 

t show 20g T registers in middle column. 



AATOVA 


177777 








C0MM-ER8 


CYCLECONTROL 8 








COMM-ERl 


PCXREG 


1 








C0MM-ER2 


PCFREG 
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BOOT- ERR 


DBREG 
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TPC 
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SBREG 
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1 
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14 
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BOOTREASON 
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6668 
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8 
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Loaded: KERNEL 

Go at 8: BEGIN, BrkP after 8:QERR+1 at B:QERR+2 



Exit Boot Run-Prog Read-Cmds Break UnBreak ClrAddedBPs ClrAllBPs ShowBPs Go 
SS Continue Load LdSyms Compare Test-All Test Dump Show-Cmds Write-Cmds 
Absolute 

BEGIN; 
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PARC 

14 June 1983 



To: Microcode Developers 

From: Edward Fiala 

Subject: How to Debug Dolphin Microcode With Midas 

Filed On: [lndlgo]<DODocs>DebugWithMidas.Bravo, Press 

This is a short description of how to debug Pilot, Cedar, or AMesa microcode with Midas. It 
handles any combination of microswitch/Star keyboards and CSL/LF monitors. 
Documentation for Midas can be found on [lndigo]<DODocs>DOMIdas.Press. You should 
read both the Midas document and the part of "Dolphin Booting and Maintenance Panel 
Codes" ([lndigo]<DODocs>MPCodes.press) which describes booting. 

Midas is a debugging program that runs under the Alto OS on a different machine from the 
one you are debugging. You can run it on an Alto or on the Alto partition of a Dolphin. In 
either case, you need a special cable to connect the printer interface of the Alto or Dolphin 
running Midas to the printer interface of the Dolphin being debugged. 

If you don't already have a Midas disk, you will need to build one: 

1 Spin up a clean disk on your Alto. Boot the NetExec and invoke NewOS. Use the 
long installation dialog and erase the disk. If you going to run Midas on a Dolphin, you 
don't have to do this-just make sure there are 2000 free pages on your Alto partition. 

2. Obtain the following files from the place where you get Alto subsystems (e.g., 
[Maxc]): 

MIcro.run (microcode assembler) 

MicroD.run (microcode loader) 

Ftp.run 

Bravo.cm and execute this command file 

RunMesa.run 
Empress.run 
Find.run 
Waterllly.run 

3. Load DOMIdasRun.dm and retrieve the other files below from [Indigo] with Ftp: 

<DOSource>DOLang.Mc 

<DO>DOMidasRun.dm 

<DO>Midas.programs 

<DO>MemErrors.mldas 

<DO>MakeLoaderFile.bcd (microcode boot file builder) 
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Because of file name conflicts, you can only have one of the following dumps of 
microcode sources loaded at-a-time (except that Initial can coexist with Pilot microcode 
if Pilot microcode is loaded last): 

<DOSource>CedarUCode.dm for Cedar microcode 

<DOSource>PilotUCode.dm for Pilot microcode 

<DOSource>AMesaSources.dm for AMesa microcode 

<DOSource>lnitialSources.dm for Initial microcode 

4. Call Ed Fiala or send message to Fiala.Pa if you have problems with these 
procedures. 

There are several important limitations to the ways in which Midas can be used to debug a 
Dolphin The first is that you must BEGIN with Midas. If Instead you attempt to attach to a 
machine which is in an interesting state, then Midas will boot the machine while activatmg its 
Kernel microcode, and all RM registers and the TPC's for the tasks will be reset (possibly 
storage will survive booting, however). 

The second limitation Is that the various microcode systems that you run must all reserve 
space for the Midas Kernel and have an appropriate linkage between the fault handler and 
the Midas Kernel. Initial has an IMReserve for the Midas Kernel; If you assemble the Pilot 
microcode with WithMldas = 1 in GlobalDefs.Mc, then Pilot also has an IMReserve for the 
Midas Kernel. SDD Pilot microcode at the present time is built with WithMidas=1, but the 
Cedar and Tor variants are not, and the normally released Alto emulator overwrites the Midas 
Kernel, so you will need to obtain or create special debugging versions of these to debug 
from Midas. 

The third limitation is that you cannot activate Pilot directly from Midas by loading and 
running .Mb files. Instead, you must install the Pilot germ and microcode on the Dolphin 
SA4000 and then load the microcode by running the Initial microcode from Midas. The 
microcode installed on the SA4000 must be the SAME as that on your Midas debugging disk. 
In addition, you must have a Physical Boot Volume set. 

Using Midas to Boot Pilot 

Boot the Midas disk and type "Midas/i Pilot". The PllotMldas command file will first load 
Initial Mb, insert a breakpoint at RamLoaded, and start Initial at SAPilotStart. If all goes 
properly, Initial will read the Pilot microcode and all of its overlays from your SA4000 into 
storage, and the breakpoint at RamLoaded will be hit after LoadRAM has loaded Pilotl into 
the microstore; then Pilotl symbols are loaded by RunProg and the RamLoaded breakpoint 
is reinserted in octal (at IMX 316); this is necessary because all previous symbols and 
breakpoint information (which pertained to Initial) have been flushed by Run-Prog; since the 
space occupied by the LoadRAM module in Initial has been IMReserved in Pilot, the 
RamLoaded symbol is no longer available. 

The Pilot.Mldas command file pauses at this point with a message saying that Pilotl is 
loaded, and you may abort the command file or continue it. If you continue the command 
file it will pause again at BootEmulators In Inltlalize.Mc after comleting all device initialization 
but before loading the Pilot2 overlay. If you continue from there, it will pause a final time 
after loading the Pilot2 overlay; if you continue from there, your physical boot volume will be 
started. 
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Assuming that you abort the first time the Pilot.l^idas command file pauses, then you have 
the following options: 

a) Kill the IMX 316 breakpoint and proceed, letting Pilot start normally. After it is running, 
you can get control with Midas control-C (or by selecting and left-buttoning "Abort") and 
establish a suitable debugging context as discussed below. 

b) Insert any breakpoints in Plloti that you wish and continue. This allows debugging 
initialiiiation and other Plloti microcode. 

c) If you want to debug the terminal microcode, then the driver for the LF keyboard system is 
included in Plloti, so you can insert breakpoints directly; for a CSL keyboard system (with 
either a CSL or LF monitor), you must proceed from the RamLoaded breakpoint-the next 
time you get to that breakpoint, the microcode for that terminal, obtained from the first or 
second overlay in PilotDO.Eb or CedarDO.Eb, will have been loaded Into the microstore. See 
below for establishing a debugging context. 

To debug Pilot2 microcode, you should continue the command file until it indicates that 
Pilot2 has been loaded; then abort it. 

Displaying Pilot Microcode Symbols From Midas 

When Pilot has been loaded and started as described above, you can setup a debugging 
conte:<t by doing Run-Prog on PIL0T1 SYMBOLS, PIL0T2SYMB0LS, CSLSYMBOLS, or 
CSLFSYMBOLS. Run-Prog clears all previous symbols and breakpoints and loads symbols 
from one of the four Pilot overlays-it is impossible to have symbols from more than one 
overlay concurrently active. PILOT1 SYMBOLS and PILOT2SYMBOLS also setup the middle 
columm of the Midas display with registers generally of interest when debugging Pilot 
emulator code; CSLSYMBOLS and CSLFSYMBOLS setup the middle column with registers 
generally interesting when debugging one of the display drivers. 

At any time you can change the contents of the Midas display by doing Read-Cmds on a 
variet/ of files in the menu with suggestive names. Among these are the following: 

BBREGS Displays BitBIt registers in middle column. 

RDCREGS Displays RDC registers in middle column. 

GCDEBUG Displays CedarGC registers. 

MEMERRORS Displays memory error registers In right column. 

TX* Various TextBIt registers. 

Using Midas to Debug AMesa microcode 

1 . Obtain a special debugging version of the Alto emulator that contains an IMReserve for 
the Midas Kernel-normal Alto microcode overwrites the Kernel and cannot be used. 
[lndigo]<DO>NewAMesa.Mb with CSL keyboards or [lndigo]<DO>LFAMesa.Mb with LF 
keyboards are suitable; put one of these on your Midas disk. 

2. Boot the Midas disk and type "NewAMesa;L"; this loads the Alto microcode. Start the 
Alto emulator with "EGO;G" "KGO;G" or "KG0P2;G" for ether boot, partition 1 boot, or 



How to Use Midas with Pilot 

partition 2 boot, respectively. The Alto Executive will appear shortly on the screen. 

Eprom Microcode 

Sources and other files for the Rev-L EPROM microcode are on 
[lndigo]<DOSource>Proms>Rev-L>*. After you rebuild the .mb file for the EPROM microcode 
from the sources, you can debug it from Midas as follows: 

1. Select Run-Prog on the Midas menu. 

2. When the Run-Prog menu appears, select EPROM. 

When SA4000Boot is loaded and the next menu appears, you can select "CONTINUE" to 
continue the boot sequence with the Initial microcode, obtained from the Initial microcode 
area of the SA4000. 

Loading Initial 

To load the Initial microcode, use the Initial command file: 

1. Select Run-Prog on the Midas menu. 

2. When the Run-Prog menu appears, select INITIAL. 

When the command file is finished, the display will show some symbols of interest for the 
Memlnit.Mc module. The various starting addresses are on pages 1 and 2 of Initial.Mc; they 
include the following: 

SAAItoStart boots and starts AMesa from the SA4000. 

SAPilotStart boots and starts Pilot from the SA4000. 

EtherAltoStart boots and starts AMesa from the 3 mb Ethernet. 

EtherPilotStart boots and starts Pilot from the 3 mb Ethernet. 

Some Interesting breakpoints in Initial are the following: 

RamLoaded (IMX 316) where LoadRAM finishes. 

IMap beginning of the map and storage test. 

ImRepeatStorageTest after map test.; here you can change the contents of 

the SoftQThreshold register to 100b if you want to make the storage 
test put pages with correctable errors into service. 

MemlnitDone end of storage test. 

MicrocodeLoaded after loading microcode into the VM block at 1400b. 



